home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / vthing12.zip / VT.DOC < prev    next >
Text File  |  1993-01-11  |  20KB  |  456 lines
  1.  
  2.  
  3.  
  4.                                    VOC THING
  5.                                   -=-=-=-=-=-
  6.              Copyright (c) 1992 Melvin Douglas All Rights Reserved
  7.                    Recorder/Player for VOC Format Sound Files
  8.                                 for use with a
  9.                            Sound Blaster Sound Card
  10.                            Version 1.2 January 1993
  11.                                   Shareware
  12.                               FAX (516)-533-2633
  13.  
  14.  
  15. Purpose: RECORDS and PLAYS VOC (Voice) Sound Files for Sound Blaster Owners.
  16.  
  17.  
  18. -----------
  19. LEGAL STUFF:
  20. -----------
  21.  
  22.     VOC THING software is hereafter referred to as VOC THING or VT.
  23.  
  24.     Users of VT must accept this disclaimer of warranty:
  25.  
  26.     "VOC THING IS  SUPPLIED AS IS.   THE AUTHOR DISCLAIMS  ALL  WARRANTIES,
  27.     EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,  THE WARRANTIES OF
  28.     MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.   THE AUTHOR ASSUMES NO
  29.     LIABILITY FOR DAMAGES,  DIRECT OR CONSEQUENTIAL,  WHICH MAY RESULT FROM
  30.     THE USE OF VOC THING."
  31.  
  32.     VT  IS A "SHAREWARE PROGRAM"  AND IS PROVIDED AT NO CHARGE TO THE  USER
  33.     FOR EVALUATION.  FEEL FREE TO SHARE IT WITH YOUR FRIENDS, BUT PLEASE DO
  34.     NOT GIVE IT AWAY ALTERED OR AS PART OF ANOTHER SYSTEM.   THE ESSENCE OF
  35.     "USER-SUPPORTED"   SOFTWARE IS TO PROVIDE PERSONAL COMPUTER USERS  WITH
  36.     QUALITY SOFTWARE WITHOUT HIGH PRICES,  AND YET TO PROVIDE INCENTIVE FOR
  37.     PROGRAMMERS  TO  CONTINUE TO DEVELOP NEW PRODUCTS.   IF YOU  FIND  THIS
  38.     PROGRAM  USEFUL AND FIND THAT YOU ARE USING VOC THING AND  CONTINUE  TO
  39.     USE VOC THING AFTER A 21 DAY TRIAL PERIOD, YOU MUST MAKE A REGISTRATION
  40.     PAYMENT OF $9.00 U.S DOLLARS.
  41.  
  42.         To register this copy, print and complete the REGISTER.FRM file
  43.         and send it along with the registration fee of $9 directly to:
  44.  
  45.                            Melvin Douglas
  46.                            Post Office Box 141
  47.                            Uniondale, New York
  48.                            11553-0141
  49.  
  50.         Sound Blaster is a registered trademark of Creative Labs Inc.
  51.         PKZIP and PKUNZIP are registered trademarks of PKWARE Inc.
  52.         QuickBasic is a registered trademark of Microsoft Corp.
  53.  
  54.                PROGRAM FILES:
  55.                -------------
  56.                VT.EXE        - Voc Thing program
  57.                VT.DOC        - Voc Thing documentation
  58.                REGISTER.FRM  - Registration form
  59.                FILE_ID.DIZ   - BBS file description text
  60.                VENDOR.DOC    - Vendor distribution agreement
  61.                *.VOC         - Several VOC files
  62.  
  63.     In  case you don't read any further,  note that you may use any key  on
  64.     the command line as a switch to bypass the opening screen:  i.e.,   "VT
  65.     X".   Additionally,  you may type "VT REC"  to go directly to RECORD
  66.     MODE, or VT filename.VOC, where "filename.voc" is a voice file that you
  67.     want to play from the command line (Use of the extension is OPTIONAL).
  68.     If playing sounds from a compressed (.ZIP) file, then you must indicate
  69.     the compressed file name i.e., VT MYVOCS.ZIP (extension is MANDATORY)
  70.     and PKUNZIP must be in your PATH or in the current directory.  Your ZIP
  71.     file must be in the current directory.
  72.  
  73. ---------------------
  74. HARDWARE REQUIREMENTS:
  75. ---------------------
  76.  
  77.     o  An IBM PC/XT/AT/386/486 or true "compatible" running
  78.        MS-DOS or PC-DOS 3.x or later.
  79.  
  80.     o  640K Conventional Memory.
  81.  
  82.     o  CGA/EGA/VGA Video Adaptor.
  83.  
  84.     o  One floppy disk drive and a hard drive.
  85.  
  86.     o  A Sound Blaster Sound board.
  87.  
  88.     o  A Microphone or other device for recording.
  89.  
  90.     NOTE: No "drivers" are required to run VT.
  91.  
  92.    --> Configure your system so that you free up the maximum amount of
  93.        memory for recording sessions.
  94.  
  95.    --> All ZIP/VOC/SAV files are assumed to be in the current directory.
  96.  
  97.   Active Play/Record Controls are as follows:
  98.   ------------------------------------------
  99.  
  100.   -  Pause sound.
  101.   -  Continue sound from a paused state.
  102.   -  Skip the current sound.
  103.   -  Cancel sound play mode and return to the Main Menu.
  104.   -  Cancel sound play mode and return to the File Selection Window.
  105.   -  Record up to a 30 second sound file.
  106.   -  Review a recorded sound file.
  107.   -  Save or Load a Play Session.
  108.   -  Save and Play your own voice files.
  109.  
  110. --------------------
  111. COMMAND LINE OPTIONS:
  112. --------------------
  113.  
  114. As mentioned earlier, any single alphanumeric character on the command line
  115. will allow you to bypass the opening screen ie., "vt z",  where "z"  may be
  116. any printable letter or number.   Type "vt rec"  to access the Record Mode.
  117.  
  118. You  can  also play a single voice file directly from the command  line  by
  119. typing  the filename i.e.,  VT FUNNY.VOC will play the voice file with  the
  120. name FUNNY.VOC and return to DOS upon completion.  The ".VOC"  extension is
  121. optional but if an extension is used, it must be ".VOC".
  122.  
  123.          For Those Who Own And Are Familiar With PKZIP/PKUNZIP
  124.  
  125. You  may  play  sound  files  that have  been  compressed  with  the  PKZIP
  126. compression  utility  program.    To play a "Zipped"   file,   specify  the
  127. compressed filename on the command line i.e., "vt rocknrol.zip".  Note that
  128. you MUST include the file extension of ".ZIP" with the filename.   You MUST
  129. have PKUNZIP in your PATH statment or in the same directory that VOC  THING
  130. is  in.    The  compressed  ZIP file must  be  in  the  current  directory.
  131.  
  132. ---------------------
  133. FILE SELECTION WINDOW:
  134. ---------------------
  135.  
  136. You may invoke the File Selection Window by typing ALT + V.  A listing of
  137. VOC files will be displayed if they are present in the current directory.
  138.  
  139. -----------------------
  140. FILE SELECTION COMMANDS: ALT + V  Activate File Selection Window
  141. -----------------------
  142.  
  143. NOTE:  YOU MUST "TAG" A FILE IN ORDER TO PLAY IT (Right Arrow Key).
  144.        i.e., TAG IT BEFORE PRESSING ENTER TO PLAY IT.
  145.  
  146. Tag  one file at a time by pressing the  RIGHT ARROW key, or <Shift> RIGHT
  147. ARROW key.   Unshifted,  the highlighted bar will move down one file  after
  148. each tag.   Shifted,  it will move up one file.  Un-tag is exactly the same
  149. except using the LEFT ARROW key.
  150.  
  151. <Num  Lock> will produce the same effect as <Shift> Left or  Right  arrows.
  152.  
  153. Tag  all files using (Ctrl> RIGHT ARROW,  and un-tag all files with  <Ctrl>
  154. LEFT ARROW.
  155.  
  156. Pressing RETURN after selecting files will immediately begin the Play  mode
  157. and sound will start.  If you press Escape after making a selection(s), the
  158. selected files will be abandoned and you will be returned to the main menu.
  159.  
  160. Additionally, if you press RETURN without selecting any files, you will be
  161. returned to the main menu.
  162.  
  163. ----------
  164. SORT FILES:
  165. ----------
  166.  
  167. Sorting is easy, just pick a number (as follows):
  168.  
  169.     1 = Sort by filename.
  170.     2 = Sort by file size.
  171.     3 = Sort by file date.
  172.  
  173. -----------
  174. TOGGLE SAVE: ALT + S
  175. -----------
  176.  
  177. After selecting voice files from the File Selection Window, VT will ask you
  178. if you wish to save these sounds to a master disk file (Session File),   so
  179. that   you   may   replay   them  later  in   exactly   the   same   order.
  180.  
  181. If you do not wish to be asked this question each time you make selections,
  182. then press "Alt+S" to turn the "Save Request" question OFF.  You may toggle
  183. it ON or Off from the main menu as often as desired.
  184.  
  185. If  the above command is "ON",  and you respond by pressing "Y"  (for  YES)
  186. when asked to save your session,  a File SAVE screen will appear  prompting
  187. you for a filename for the session to be saved.   Enter a filename of up to
  188. 8 characters but do NOT include any file extension.   VT will automatically
  189. add an extension of ".SAV"  to all saved sessions.   You will be advised if
  190. the    file   already   exists   to   avoid   overwriting   other    files.
  191.  
  192. After the file has been successfully saved, your current selections will
  193. begin playing immediately.
  194.  
  195. If you do not wish to save the current session, you may press "N" (NO),  or
  196. simply press the ENTER KEY since "NO"  is the default choice.   If you  are
  197. already in the File Save screen and change your mind, you may press ESCape.
  198.  
  199. -------------
  200. LOAD SESSION: (ALT + L)
  201. -------------
  202.  
  203. To play a saved session,  start VT then press ESCape to exit from the  File
  204. Window,  then type ALT+L.  A File Window entitled "Session(s)"  will appear
  205. with a list of all of your session filenames.   To select a session file  ,
  206. simply  move  the highlight bar using the Up or Down Arrow  keys  and  then
  207. press  ENTER.    VT  will load that session  and  begin  PLAY  immediately.
  208.  
  209. When  you press ALT + L, VT will first search the current directory to make
  210. certain  that there are Session Files on your disk.   If none are found, VT
  211. will pop up an advisory message.
  212.  
  213. CAUTION:   REGARDING  THE FILENAMES THAT ARE STORED WITHIN  YOUR  "SESSION"
  214. FILE:  IF ANY OF THE FILES ARE MISSING, VOC THING SHOULD BE ABLE TO  HANDLE
  215. THE PROBLEM AND CONTINUE.  HOWEVER ANYTHING IS POSSIBLE,  SO IF THE PROGRAM
  216. STALLS,   CHECK  FOR  MISSING FILES.  IF VOC THING IS ABLE  TO  HANDLE  THE
  217. FILENAME ERROR,  OBVIOUSLY YOU WILL NOT HEAR THE MISSING SELECTION(S),  BUT
  218. THE STATUS WINDOW WILL DISPLAY A "FILENAME MISSING"  MESSAGE AND PLAY  WILL
  219. CONTINUE WITH THE NEXT SELECTION IN THE QUEUE IF ANY.
  220.  
  221. EDITING THIS FILE IS NOT RECOMMENDED.  IF YOU EDIT THE "XXXXXXXX.SAV"  FILE
  222. AND ALTER ANY OF IT'S ENTRIES, VOC THING MAY EXHIBIT UNPREDICTABLE BEHAVIOR
  223. AT BEST OR MAY CRASH AND LOCK UP YOUR SYSTEM AT WORST.
  224.  
  225.                       COMMANDS AVAILABLE IN THE "PLAY" MODE
  226.                       -------------------------------------
  227.  
  228. -------------
  229. PAUSE Command: (P)
  230. -------------
  231.  
  232. Pressing  "P"  will temporarily PAUSE the current sound.   While  PAUSE  is
  233. active,   the  CONTINUE command is highlighted and other commands  will  be
  234. visually de-emphasized.
  235.  
  236. NOTE:  Occasionally, when you select the PAUSE command, it may get stuck on
  237. a sound that refuses to be silent.  If this happens, use the "C"  command to
  238. CONTINUE  and  then use the "P"  command again until the sound  fades  out.
  239.  
  240. ----------------
  241. CONTINUE Command: (C)
  242. ----------------
  243.  
  244. Pressing "C"  will CONTINUE a sound, or reverse a PAUSE command. Sound will
  245. resume playing from the point that it was PAUSED.
  246.  
  247. ------------
  248. SKIP Command: (S - or you may press the Spacebar)
  249. ------------
  250.  
  251. Pressing "S"  will terminate the current sound and will PLAY THE NEXT sound
  252. in  the queue immediately.   You may also use this command to move  to  the
  253. next sound if the current file gets "stuck" or just stops playing (probably
  254. a corrupt file).  You  may also  press the SpaceBar to invoke this command.
  255.  
  256. The  term "skip"  in this instance means that the file was  aborted  during
  257. play   rather   than   actually  "skipped  over"    before   being   heard.
  258. You will notice a short delay as the next file is loaded for playing.
  259.  
  260. ---------------------------
  261. FILE WINDOW  [EXIT] Command: (F)
  262. ---------------------------
  263.  
  264. Pressing "F"  will terminate VT's Sound play  mode and return  you to   the
  265. FILE  SELECTION WINDOW where you may select more files to play or execute
  266. some other command from the main menu.
  267.  
  268. During play from a compressed (ZIP) file, pressing "F" will terminate the
  269. program and return you to DOS.
  270.  
  271. ------------
  272. EXIT Command: (X - or you may press the Escape Key)
  273. ------------
  274.  
  275. Pressing "X"  or Escape will shut down VT's sound play mode and return  you
  276. to the main menu.   On the other hand,  when the last file has been played,
  277. VT will exit the Play Mode and return you to the main menu.   At that point
  278. the File Selection Window will pop-up automatically.
  279.  
  280. During Play from a compressed (ZIP) file, pressing "X" will terminate the
  281. program and return you to DOS.
  282.  
  283. -------------------
  284. ENDING THE PROGRAM: (ESC - from main menu)
  285. -------------------
  286.  
  287.                          COMMANDS FOR RECORDING VOC FILES
  288.                          --------------------------------
  289.  
  290. ** NOTE:
  291.  
  292.    Make certain that you give VT the MAXIMUM AMOUNT OF MEMORY that can be
  293.    made available before running it.
  294.  
  295.    You may have to adjust your volume while in the RECORD MODE.  Generally,
  296.    good speakers and a decent microphone will increase the quality of  your
  297.    recordings.    Thirty seconds may not seem like a lot of recording  time
  298.    however,   sound files consume a lot of memory and can get  quite  large
  299.    very  quickly.    The size of the buffer will be displayed  during  your
  300.    interaction to let you know how large the resulting file will be if  you
  301.    save  it.    Increasing the TIME and the SAMPLE RATE will  increase  the
  302.    memory  required  for the sound data.
  303.  
  304.    Prior  to  allowing the creation of a buffer,  VT  will  calculate  it's
  305.    expected size and compare the results with remaining memory (minus a 32k
  306.    safety-net).  If the buffer will be too large for remaining memory, then
  307.    you will be advised via a pop up error message.   You should reduce  the
  308.    Sample   Rate  and/or  the  number  of  Seconds  before  trying   again.
  309.  
  310.    After recording your own sound files,  you may wish to compress them  or
  311.    otherwise  manipulate  them  with  the Sound  Blaster  VOXKIT  or  other
  312.    programs that came with your Sound Blaster package.
  313.  
  314. --------------------
  315. RECORD MODE Command: ALT-R  Activate Record Mode
  316. --------------------
  317.  
  318. First, ensure that your Microphone is connected and ready or that your
  319. alternate sound source is connected if you are not using a microphone.
  320.  
  321. From the Main Menu:
  322.  
  323. Press ALT-R to active Record Mode.  You will be presented with the RECORDING
  324. Control Screen.  Follow these steps to record and replay a VOC file:
  325.  
  326.       1 - Upon entering record mode,  the "S"  (Seconds)  will be  flashing
  327.       prompting you to press "S" to enter the "Time Select" mode.  However,
  328.       if  you wish you may change the Sample Rate FIRST by using the Up  or
  329.       Down  Arrow  keys  to increase or decrease the  number  of  "Samples"
  330.       used.* Changes are in increments of 100.  The Sampling Rate scale on
  331.       the bottom will slide left or right as you vary your selection.
  332.  
  333.       To set the number of seconds,  type a number representing the  number
  334.       of seconds you desire.  For instance, type "8" if you want to make an
  335.       8  second  recording.    There is a 3 second minimum  and  a  default
  336.       Maximum  of 30 seconds.   You may press the ENTER KEY TO  ACCEPT  THE
  337.       DEFAULT.  Your choice will be displayed for verification.
  338.  
  339.       2  - You will be advised to **TURN ON YOUR MICROPHONE if you have not
  340.       already  done so.   The prompt will ask you to press ENTER  to  begin
  341.       your recording session.  Once you press the ENTER key, VOC THING will
  342.       transmit  all  sound  from  your microphone into  a  buffer  for  the
  343.       selected   number   of   seconds  determined   in   step   1   above.
  344.  
  345.       3  - Upon completion of the recording session,  you will be asked  if
  346.       you want to REPLAY your recording to verify the content and  quality.
  347.       You may replay it as many times as desired.
  348.  
  349.       4  - After responding "N"  (NO)  to the Replay request,  you will  be
  350.       asked if you wish to save the sound data to a disk file.   "N"   (NO)
  351.       will return to the Record Mode.  "Y"  (YES)  will display a File SAVE
  352.       screen  which  will  prompt you to enter an  8  character  (or  less)
  353.       filename  for  the file.   DO  NOT  INCLUDE AN EXTENSION.    VT  will
  354.       automatically add an extension of "VOC".   The message window at  the
  355.       bottom  of  the  screen will advise you of  any  situation  that  may
  356.       require your attention.
  357.  
  358.       5 - After your file has been saved as a "VOC"  file,  you may PLAY it
  359.       from the main menu by pressing ALT+V and "Tagging" it with the  Right
  360.       Arrow key, and then press ENTER.
  361.  
  362.       ** Microphone, Device or other direct source of sound.
  363.  
  364.       * See your Sound Blaster manual for more information on "Sampling" and
  365.         how it affects recordings.  The Sampling Rate may be increased or
  366.         decreased in increments of 100 to a maximum of 12000 Hz.  Note that
  367.         increasing the Recording Time and/or Sample Rate require a relative
  368.         increase in buffer memory.
  369.  
  370.       During Record Mode, the following information is provided:
  371.  
  372.          - The number of seconds you have selected.
  373.          - ReCrd: The number of Recordings you have completed.
  374.          - Sav:   The number of Recordings you have saved to disk.
  375.          - The currently valid Sample Rate and the maximun Frequency.
  376.          - The size of the Buffer (your sound data).
  377.          - The amount of conventional memory available.
  378.          - The percent of memory in use.
  379.          - A dynamic display of the number of seconds elapsed while
  380.            Recording or during Play (or Replay), both numeric and graphic.
  381.  
  382. Press  "ESCape" to return to the main menu from the Record Mode.
  383.  
  384. Pressing ESCape from the main menu will terminate VT and return you to  the
  385. DOS  prompt (assuming the File Selection Window was not active).    If  the
  386. File Selection Window is active, pressing ESCape 3 times will terminate VT,
  387. and  return  you  to the DOS prompt while displaying a  low  key  shareware
  388. screen and session time.
  389.  
  390.                          Errors and/or Problems
  391.  
  392. If  a  VOC  file  hangs your system then it may  be  that  it  was  created
  393. elsewhere and does not have a "header".  You can add a "header" to the file
  394. using your VOC-HDR program that came with your Sound Blaster.   Also,   the
  395. file may not actually be a VOC file i.e., some other file with an extension
  396. of VOC.
  397.  
  398. If a file is too large for your remaining memory,  try compressing it  with
  399. VOXKIT which also came with your Sound Blaster.   Select DATA-PACKING  from
  400. the VOXKIT main menu.  When creating a file (recording), VOC THING will let
  401. you  tailor your Sampling Rate and Duration to control the  resulting  file
  402. size.    After saving the file,  you may wish to use the VOXKIT program  to
  403. compress it since no compression is performed when a newley created VOC  is
  404. saved.
  405.  
  406. If a Zipped File is already on the current drive (as well as inside your ZIP
  407. file), VOC THING will erase the copy on the disk first before proceeding to
  408. expand the Zipped copy.
  409.  
  410.                             Version History
  411.  
  412.     Version 1.0  = August 1992 Initial Release.
  413.     Version 1.1  = Added 10 Second Record Sound feature. (12/92)
  414.                    Added File/Session Save feature.
  415.     Version 1.2  = Enhanced Session Retrieval option. (1/93)
  416.                    Increased Record Time to 30 Seconds.
  417.                    Memory Alert. Sampling-Rate Scale.
  418.                    Play sounds from a compressed (ZIP) file.
  419.                    Enhanced screens. Better documentation.
  420.     ---------------------------------------------------------------------
  421.     Questions or problems? My direct FAX number is (516) 538-2633.
  422.  
  423.     The latest version of VT may be found on the following bulletin boards:
  424.     ---------------------------------------------------------------------
  425.                 1 -  The Executive Network BBS, New York
  426.                      914-667-4684 all baud speeds
  427.     ---------------------------------------------------------------------
  428.  
  429.                 2 -  The Invention Factory, New York
  430.                      212-274-8930
  431.  
  432.                 3 -  Computer Connection, Washington, D.C.
  433.                      202-547-2008
  434.  
  435.                 4  - Vernon Buerg's BBS, Calif.
  436.                      707-778-8944
  437.  
  438.                 5  - Gene Plant's BBS, Illinois
  439.                      708-843-2772
  440.  
  441.                 6  - The SoundBlaster Digest BBS, Toronto
  442.                      416-840-2485
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.